This PR reworks how some parts of atmos code work. Originally it was just meant to be a performance and bugfix PR, but it has ballooned in scope. I'm not sure about some of my changes largely because I'm not sure if some things were an oversight or an intentional decision for some reason.

List of changes:

• The MolesArchived float[] field is now read-only
  • It simply gets zeroed whenever the GasMixture is set to null instead of constantly reallocating
• Airtight query information is now cached in TileAtmosphere
  • This means that it should only iterate over anchored entities once per update.
  • Previously an invalidated atmos tile would cause ProcessRevalidate() to query airtight entities on the same tile six times by calling a combination of GridIsTileAirBlocked(), NeedsVacuumFixing(), and GridIsTileAirBlocked(). So this should help significantly reduce component lookups & entity enumeration.
  • This does change some behaviour. In particular blocked directions are now only updated if the tile was invalidated prior to the current atmos-update, and will only ever be updated once per atmos-update.
  • AFAIK this only has an effect if the invalid tile processing is deferred over multiple ticks, and I don't think it should cause any issues?
• Fixes a potential bug, where tiles might not dispose of their excited group if their direction flags changed.
• MapAtmosphereComponent.Mixture is now always immutable and no longer nullable
  • I'm not sure why the mixture was nullable before? AFAICT the component is meaningless if its null?
  • Space "gas" was always immutable, but there was nothing that required planet atmospheres to be immutable. Requiring that it be immutable gets rid of the constant gas mixture cloning.
  • I don't know if there was a reason for why they weren't immutable to begin with.
• Fixes lungs removing too much air from a gas mixture, resulting in negative moles.
• GasMixture.Moles is now [Access] restricted to the atmosphere system.
  • This is to prevent people from improperly modifying the gas mixtures (e.g., lungs), or accidentally modifying immutable mixtures.
• Fixes an issue where non-grid atmosphere tiles would fail to update their adjacent tiles, resulting in null reference exception spam
  • Fixes #21732
  • Fixes #21210 (probably)
• Disconnected atmosphere tiles, i.e., tiles that aren't on or adjacent to a grid tile, will now get removed from the tile set. Previously the tile set would just always increase, with tiles never getting removed.
• Removes various redundant component and tile-definition queries.
• Removes some method events in favour of just using methods.
• Map-exposded tiles now get updated when a map's atmosphere changes (or the grid moves across maps).
• Adds a setmapatmos command for adding map-wide atmospheres.
• Fixed (non-planet) map atmospheres rendering over grids.

Media

This PR also includes changes to the atmos debug overlay, though I've also split that off into a separate PR to make reviewing easier (#22520).

Below is a video showing that atmos still seems to work, and that trimming of disconnected tiles works:

new.mp4

For comparison, here is a video showing how current master works (disconnected tiles never get removed):

master.mp4

🆑

• fix: Fixed a bug where partially airtight entities (e.g., thin windows or doors) could let air leak out into space.